home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 1
/
Cream of the Crop 1.iso
/
PRINTER
/
DISKLS25.ARJ
/
DISKLIST.DOC
< prev
next >
Wrap
Text File
|
1992-04-07
|
70KB
|
1,558 lines
D I S K L I S T
Prints a Directory Listing on any Printer
DISKLIST is a commercial program and is copyrighted.
It is distributed using the Shareware marketing
concept. The Shareware concept allows you to try the
fully functional program on your own computer before
you buy it. If you continue to use DISKLIST or keep
it for when you might use it, then you MUST send the
$25 registration fee to the author. Press F to print
the registration form from the program.
When you register DISKLIST you will receive:
Telephone and mail support.
A copy of the latest version of DISKLIST
Removal of the Registration Screen & reminders.
Skip the Help screen at the start of the program.
Skip the Registration Form reminder at the end
of the program.
A loan amortization program with both the
BASIC source code and the compiled
program. No registration is required for
the amortization program.
A copy of SHERLOCK for you to try before
registering.
_______
____|__ | (R)
--| | |-------------------
| ____|__ | Association of
| | |_| Shareware
|__| o | Professionals
-----| | |---------------------
|___|___| MEMBER
Table of Contents
-----------------
OVERVIEW...............................1
FASTSTART..............................2
OPERATION..............................3
PARAMETERS and COMMANDS................4
LIST FORMATS...........................7
NONLASER PRINTER CONTROL CODES.........9
LASER COMMANDS........................11
DESKJET...............................13
AVERY LASER LABELS....................14
PRINT ON DISK SLEEVES.................16
SWITCH PRINTER PORT...................16
PAGE TAB VALUE........................17
LASER DOWNLOAD........................17
TEXT INPUT............................17
STATUS MESSAGES...................... 18
MONOCHROME MONITOR....................18
SUMMARY OF NON-DISPLAYED COMMANDS.....19
FILENAMES............................ 19
DISKFLAP..............................20
SHAREWARE............................ 20
MULTICOPY FEES........................22
FOREIGN REGISTRATIONS.................22
EPILOGUE..............................22
COMMERCIAL LABELS.....................23
PERSONAL TRIMMER......................23
OMBUDSMAN............................ 24
IBM GRAPHICS EXAMPLE..................25
Copyright 1991, 1992
John P. Bauernschub, Jr.
Gulf Sierra
14809 Clavel Street
Rockville, MD 20853
301-460-0354
CompuServe ID 73270,77
OVERVIEW
DISKLIST is designed to print the directory of any disk, including
subdirectories, on a stick on label, a sheet of paper that can be
cut to the size of the diskette, on a disk sleeve, on an 8.5 x 11
sheet, the screen, or a disk file. The list can be in a format
that is the size of the floppy so that it can be attached to the
floppy, or, if on paper, trimmed to fit into the floppy sleeve.
DISKLIST lists the contents of all of the subdirectories on the
disk. DISKLIST provides an easy method to configure the output.
Here is an example of one form of the output of DISKLIST.
--------------------------------------------------
| GREAT SHAREWARE |
| Volume ID is DISKLIST |
| 1,457,664 Total Space 893,440 Bytes Free |
|------------------------------------------------|
| A:\ 153,664 BYTES |
| DISKLIST.DOC 34,377 08/15/90 19:32:16 |
| DISKLIST.EXE 119,144 08/14/90 22:02:18 |
| DISKLIST.PRM 124 03/25/90 11:11:48 |
| DISKLIST.TTL 19 03/25/90 11:05:06 |
| |
| A:\PC-ACCOU.NT 230,862 BYTES |
| PCACT220.EXE 156,150 11/08/89 19:03:52 |
| PCACT220.TXT 6,838 11/09/89 18:30:42 |
| PCDOC220.EXE 67,874 11/08/89 19:09:22 |
| |
| A:\SHERLOCK 175,967 BYTES |
| SHERLOCK.DOC 30,895 08/15/90 19:35:14 |
| SHERLOCK.EXE 145,072 08/15/90 19:44:04 |
|------------------------------------------------|
| 9 Files 08-17-1990 18:46:00 |
| |
| |
| |
| |
| |
| |
| |
| Created by DISKLIST |
--------------------------------------------------
This example is in the 5.25 inch normal format for that size
diskette. DISKLIST can also print it in the 3.5 inch compressed
format for the 3.5 inch diskettes, or in the 8.5 x 11 inch page
format. There are 39 formats for you to chose from, all easily
selectable from the DISKLIST control window. They contain from 1
to 6 columns of filenames.
ASCII lines were selected for the frame of the above illustration
so that it would print properly on all printers. If your printer
-1-
can print the IBM graphics characters (lines, boxes, etc.) then
you can select IBM (unbroken) lines for your list and the frame
will be smooth single or double lines. Such an example is given
on the last page of this manual. Or you can select a format
without any lines.
Many of the formats do not have any border lines to save space so
that you can print on stick on labels. They are identified with
Label, Lab, or Page in the Format Size. Labels also leave off
the 'Created by DISKLIST'.
Printer control codes can in inserted in the program. The length
of the label in lines can be set. In the label mode, DISKLIST
will space to the next label. Each format has its own set of
laser commands. All setup parameters are saved when you exit
DISKLIST.
FAST START
To run DISKLIST, just enter DISKLIST at the DOS prompt. Read the
Shareware screen carefully, then press RETURN. The control
window and Help window are displayed. Read the Help window for
instructions on how to navigate the DISKLIST control window.
Press any key to close the Help window, it's available anytime by
pressing H. If you are using a monochrome monitor, press M to
toggle on an arrow to indicate the selected parameter. Setup the
parameters as you want them, then press P to print a list.
When registered (i.e. when you pay the author for DISKLIST), the
program will skip the Shareware screen and the help window and be
immediately ready for business. After you have used DISKLIST,
enter the F command to print the registration form, fill it out
and send it with $25 to the program author. Thanks.
When DISKLIST starts, it is ready to print the directory on the
drive it used last. This is easily changed from the DISKLIST
control window in the program by selecting the first parameter
and pressing the right or left arrow keys.
You can also select the source directory drive from the DOS
command by entering the drive letter (colon not necessary but
accepted). For example, if you were going to print the directory
of drive A: and the last drive DISKLIST used was B:, then the
command would be:
DISKLIST a
-2-
OPERATION
When DISKLIST starts, it reads several data files. These files
must be in the same directory as DISKLIST.EXE. If your operating
system is DOS 3.3 or above, you can run DISKLIST from any
directory and it will find its data files. For older versions of
DOS, make the directory DISKLIST.EXE is in the default before
running it.
To run DISKLIST, just enter DISKLIST at the DOS prompt. After
the Shareware screen, the DISKLIST control window will appear.
Parameters D I S K L I S T Commands
===================================================================
1 - Disk Drive A: H or F1 - HELP A - Space Yes
2 - Filespec *.* P - Print List Z - ZIP No
3 - Sort Files by Name L - Line Feed E - Eject Page
4 - Sort Direction Ascending T - LPT1:
5 - Output Device NonLaser Printer S - Save Title on Disk Drive
6 - Format 5 Normal R - Read Title from Disk Drive
7 - Border Line Type ASCII |---| F - Print Registration Form
8 - Lines Per List 30 C - Configuration
9 - Title for List F10 or ESC - Quit DISKLIST
The List Title is Displayed Here
Illustration of the Control Window
Press Function Key 1 or H to display the help window. It
explains how to navigate the control window. The words
Parameters and Commands on the control window only appear when
the HELP window is active.
Select a parameter by entering the sequence number of the
parameter, or move the highlight with the up and down arrow keys.
Change the parameter by scrolling through the allowable values
with the left and right arrow keys or the space bar. If you are
using a monochrome monitor, press M to toggle on an arrow to
indicate the selected parameter.
Be sure to select the proper printer (Laser or Nonlaser) with
parameter 5, Output Device. A common problem is to have the
wrong control codes sent to the printer because the wrong printer
was selected.
When parameters 2, 8 or 9 are selected, a window will open up for
text entry. Press ESC to delete the previous entry, or edit it
with the standard editing functions. Insert also works. When
the entry is complete, press the up or down arrow key or RETURN.
The input window will disappear. If you entered a title, it will
-3-
be displayed at the bottom of the control window. If you
completed the entry with a RETURN, the highlight will stay on the
parameter. Use the left or right arrow key to reopen the window.
To execute a command, press the command letter when no other
window is open.
PARAMETERS and COMMANDS
DISKLIST lets you configure your directory lists to your
requirements. The configuration is saved when you exit DISKLIST
and will be automatically read the next time DISKLIST is run.
The parameters permit you to:
Select any disk drive - floppy, hard, or ram disk.
Provide a file selection specification, Filespec.
Sort files by name, date, extension, size, or no sort.
Sort direction - ascending, descending.
Select an Output Device from these:
Laser Printer,
NonLaser Printer,
Your Computer Screen,
an Avery Laser Label,
a Disk Sleeve on a LJ III, or
Write to a Disk File.
Select a form and print size - 39 formats available
Select a border line type -
None, ASCII dashes, IBM single or double lines.
Change the number of lines to be printed on the list.
Enter a title for the list.
Read the list of commands from the Control Window figure. Most
are self explanatory. The others are discussed below.
DISKLIST supports two printer types. One is nonlaser
(mechanical) printers and the other is laser printers. The
difference has to do with which set of control codes DISKLIST
sends to the printer. The control codes for mechanical printers
are saved with the general setup parameters in the file
DISKLIST.PRM and the laser printer commands are saved in
DISKLIST.LSR. These will each be discussed separately.
As you move through the Format selections with the right and left
arrows, the Lines Per List data will change to reflect the value
for that size parameter. When the Lines Per List parameter is
selected, a window pops up for entry of the new value. The
original value that came with DISKLIST is in parens for your
reference.
-4-
When DISKLIST prints a list that is physically longer than the
diskette, either 5.25 or 3.5 inches, it will put marks on the
border indicating where to fold the paper to neatly match the
disk size. In the ASCII border line type there is a - instead of
the |. In the IBM border line type the horizontal tick mark is
part of the vertical line and is harder to notice, but it is
there. The line this prints on is determined by the value for
Lines Per List.
If you know that your list of files is short, set the Lines per
List to a lower value with parameter 8 in the control. That will
print a shorter frame. This is necessary when you are printing
on a sleeve (with a Laser Jet III) and using a format that prints
a border.
The border line type selection does not apply when the 8.5 X 11
Page, any label format, or the Display on the File is selected.
There are no borders on the 8.5 x 11 Page, Label or File outputs.
When a format for one of these is selected, Border Line Type
displays 'Not with above Fmt'. Actually the word 'above' is an
upward pointing arrow on the screen.
All of the borders are available on the output to the Screen.
None of the compressed or multiple column modes are available
when the output is directed to the Screen or File.
For the nonlaser printer, when a mode that uses compressed print
is selected, DISKLIST combines the codes for compressed on and 8
lines per inch (in that order) and prints a line with those
codes. This will cause the printer to advance one line.
Likewise, on completion of the list printing, another line with
the codes for compressed off and 6 lines per inch will be
printed. These two blank lines are included in the number of
lines per list for the nonlaser printer. So, you can put any
codes in these parameters. There is no limit to the number of
codes you may use. When a non compressed format is selected, no
codes are sent to the printer.
For a laser printer, the laser commands are always sent. There
is a set of laser commands for each format.
The printer mode with the 8.5 x 11 Page format and the File mode
are ideal for producing a list of all files on a hard drive and
saving the list in a loose-leaf notebook.
-5-
The C command pops up the following Configuration menu.
CONFIGURATION
═════════════════════════════════
1 - NonLaser Printer Codes F5
2 - Laser Commands F6
3 - Form/Printer Sizes F7
4 - Date Format MM/DD/YY
5 - Download a Font F3
6 - Print Total Space at TOP Yes
7 - Print Date-Time at TOP No
8 - Print Date-Time at BOTTOM Yes
9 - Lines to skip at label gap 0
A - Line under Title & Label No
B - A Blank Line at the Top No
C - Print File Names Yes
Select [Quit]?
You may go directly to the window for selecting the Nonlaser
Printer Control Codes (F5), the Laser Commands (F6), the Format
editor (F7), or to download a font (F3) by pressing the
associated function keys here or from the control window.
To select another data format, press 4 until the date format you
want to use is displayed. The date formats are:
MM/DD/YY DD/MM/YY YY/MM/DD
MM-DD-YY DD-MM-YY YY-MM-DD
MM.DD.YY DD.MM.YY YY.MM.DD
Toggle items 6 through 8 and A through C, Yes and No, by pressing
the selection number. These give you more control over the look
of your list and the space available for file names. When the
date and time are printed at the top of the list, the number of
files are not printed. The configuration setup is saved when you
exit DISKLIST.
Item 9, Lines to skip at label gap, will cause a nonlaser printer
to skip lines between labels when printing a list that is longer
than one label. This is intended to be used when printing on
gummed mailing labels that will be stuck to a disk. Set Lines
Per List, item 8 on the control window, to the number of lines
from the beginning of one label to the beginning of the next
label. Then enter the number of lines to be left blank. If
Lines Per List = 10 and Lines to skip at label gap = 3, then
DISKLIST will print 7 lines then skip 3, then repeat.
DISKLIST will save the title for a disk in a file on that disk
with the S command and retrieve it with the R command. DISKLIST
also prints the disk volume name at the top of the list.
-6-
The E command (Eject Page) sends a form feed to the printer. The
L command (Line Feed) sends a carriage return to the printer.
CTRL R or CTRL E sends the laser printer Reset command, ESC E, to
the printer to eject a page (it is not listed on the control
window). When these commands are sent, DISKLIST acknowledges by
beeping. If the beep is annoying, press CTRL B to turn the beep
off. Another CTRL B will turn the beep on.
Before DISKLIST prints the name of a subdirectory, it prints a
blank line. The blank line can be avoided by toggling the status
of Space to No by pressing the letter A. See the upper right
corner of the control window.
Notice the Z - ZIP in the upper right corner of the control
window. It signifies the status of DISKLIST reading the file
directory in ZIP, ARC, PAK, ZOO, and LZH files. These file names
are displayed in lower case letters to signify that they are from
an archive. These file names are not sorted. Pressing Z toggles
the status of this function between Yes and No.
LIST FORMATS
DISKLIST provides a large selection of list layouts. Some
contain all the file information, name, size, date, and time.
Others contain only the name, or the name and date, or the name
and size. You may have from one to six columns of file names on
a list. Remember, Label formats do not print any border lines
and they skip to the beginning of the next label based on the
value in Lines Per List. They also do not print Created by
DISKLIST.
The following table lists all of the Formats and indicates which
use the compressed mode. Avery stands for Avery Label. It is
also a regular label format.
Sized for
Format Diskette Columns Info Printed Pitch Type
8.5 x 11 Page 8.5 x 11 1 Name Size Date Time Page
3.5 Compressed 3.5 1 Name Size Date Time Compressed List
3.5 Comp Label 3.5 1 Name Size Date Time Compressed Avery
3.5 2 & Size 3.5 2 Name Size Compressed List
3.5 2 & Size Lab 3.5 2 Name Size Compressed Avery
3.5 2 & Date 3.5 2 Name Date Compressed List
3.5 2 & Date Lab 3.5 2 Name Date Compressed Avery
5.25 Normal 5.25 1 Name Size Date Time List
5.25 Norm Label 5.25 1 Name Size Date Time Label
5.25 Compressed 5.25 2 Name Size Date Time Compressed List
5.25 Comp Label 5.25 2 Name Size Date Time Compressed Label
5.25 2 & Size 5.25 2 Name Size List
5.25 2 & Size Lab 5.25 2 Name Size Avery
-7-
Sized for
Format Diskette Columns Info Printed Pitch Type
5.25 2 & Date 5.25 2 Name Date List
5.25 2 & Date Lab 5.25 2 Name Date Avery
5.25 3 & Size 5.25 3 Name Size Compressed List
5.25 3 & Size Lab 5.25 3 Name Size Compressed Avery
5.25 3 & Date 5.25 3 Name Date Compressed List
5.25 3 & Date Lab 5.25 3 Name Date Compressed Avery
5.25 4 & Size 5.25 4 Name Size Compressed List
5.25 4 & Size Lab 5.25 4 Name Size Compressed Label
5.25 4 & Date 5.25 4 Name Date Compressed List
5.25 4 & Date Lab 5.25 4 Name Date Compressed Label
3.5 3 Across 3.5 3 Name Compressed List
3.5 3 Across Lab 3.5 3 Name Compressed Avery
5.25 3 Across 5.25 3 Name List
5.25 3 Across Lab 5.25 3 Name Label
5.25 4 Across 5.25 4 Name Compressed List
5.25 4 Across Lab 5.25 4 Name Compressed Avery
5.25 5 Across 5.25 5 Name Compressed List
5.25 5 Across Lab 5.25 5 Name Compressed Label
5.25 6 Across 5.25 6 Name Compressed List
5.25 6 Across Lab 5.25 6 Name Compressed Label
Page 2 with All 8.5 x 11 2 Name Size Date Time Compressed Page
Page 3 & Date 8.5 x 11 3 Name Date Page
Page 4 & Date 8.5 x 11 4 Name Date Compressed Page
Page 4 Across 8.5 x 11 4 Name Page
Page 5 Across 8.5 x 11 5 Name Compressed Page
Page 6 Across 8.5 x 11 6 Name Compressed Page
The format to use is selected with item 6, Format, on the control
window. There are 39 selections.
The display at the bottom of the control window screen displays
information from the above table. It explains the selected
format in more detail. Columns are the number of groups of data
that are printed on a line and Info Printed is the data in each
group. This display can be toggled on and off with CTRL L.
The formats 5.25 2 & Date and 5.25 2 & Size print compressed when
the Output Device is Avery-Laser so they fit on the Avery label.
DISKLIST provides a way for you to quickly select a format. F7
displays the Configuration Format Menu. Move the cursor to the
format you want and press F10. That will then be the format
selected to use in the command window.
You can also use the Configuration Format Menu to create a list
of formats that you want available from the control window. If,
for example, you only have a 3.5 inch diskette, then you do not
want to scan through all the selections for 5.25 inch drives.
A diamond indicates formats selected to be available as options
-8-
from parameter 6 - Format on the control window.
Select or deselect the items you want with the space bar. Use
the cursor keys to move around the list. Press F10 when done.
This configuration will be saved when you exit DISKLIST.
Use the 8.5 x 11 format to list the files on your hard drive and
put the pages in a notebook for reference.
NONLASER PRINTER CONTROL CODES
(Laser printers users skip 2 pages to LASER COMMANDS)
DISKLIST has a generic set of nonlaser (dot matrix) printer
control codes. It only uses the codes to switch to and from
compressed (17 characters per inch) and regular (10 characters
per inch), and between 6 and 8 lines per inch for the compressed
printer modes. The default generic printer control codes work on
many printers and have been tested on the Epson FX-86e and IBM
Proprinter II.
DISKLIST provides a nonlaser printer code editor. It is
activated with the C command or directly with F5. Use it to
install your printer control codes for these functions if the
default codes do not work with your printer. It is easy to do
this with information supplied in your printer manual. These
printer control codes will be saved in the same file with the
other DISKLIST parameters when you exit DISKLIST.
When you enter the editor to change the printer codes, this
window will pop up. The figure illustrates an example when key 1
was pressed to change the codes for compressed on.
NONLASER PRINTER CODES
======================================
1 - Compressed ON 15
2 - 8 Lines per Inch 27, 48
3 - Compressed OFF 18
4 - 6 Lines per Inch 27, 50
======================================
1 to 4 - Enter the Decimal Codes
D - Restore the Default Codes
R - Restore Before Entry Codes
C - Clear All Codes
F10 - Quit and Use these Codes
======================================
Enter the codes for Compressed ON
? 15,7,65
-9-
Printer manuals contain a section or appendix on printer
commands, software commands, or control codes. These codes are
sent from the computer to the printer by DISKLIST to change the
character size and line spacing.
If DISKLIST doesn't print the directory list in a conventional
format, use the nonlaser printer code editor to tell DISKLIST
what codes to send to your printer to make it print correctly.
Your printer manual may have the codes in three different
formats, ASCII, decimal, and hexadecimal. Only enter decimal
codes into DISKLIST. These are all numbers between the values of
0 to 127. There are usually 1 to 3 numbers for each function
being changed.
Enter all of the numbers for one function on one line and
separate the numbers with a space or comma. There is no program
limit to the number of control codes you may enter. The above
figure of the codes window illustrates how a new code is being
entered for the function Compressed On.
To delete the line of codes on the prompt line, press the ESC
key. DISKLIST will only accept numbers from 0 to 255. It will
ignore all other numbers and beep as it does. It will accept any
quantity of numbers for each function but will only display those
that fit in the window.
DISKLIST only transmits these codes to the printer when a
compressed mode is selected. See the table that defines the
print formats on or near page 7.
When data on the prompt line exceeds the width of the window,
then the prompt line scrolls horizontally. You can then scroll
the data horizontally with the cursor keys; the display window
shows only the numbers that fit in the window.
The D command on the Printer Codes window will restore the built
in codes that came with DISKLIST.
If you want to print the IBM graphic lines on a DISKLIST listing,
then you must select the IBM mode on your printer. Try printing
a directory list with the IBM lines selected in DISKLIST with the
Border Line Type parameter. If it does not print the IBM lines,
read your printer manual to locate the switch to flip to activate
this mode on your printer. This applies to dot matrix printers
only.
You can now print the title and disk volume name in double strike
on dot matrix printers. Create a file named DISKLIST.C1. Put in
the decimal values of the codes to select double strike,
separated by a coma, and followed by a negative value that
indicates the quantity of values you entered after the ESC. Do
-10-
the same on the next line to cancel double strike. Try the
enclosed file, DISKLIST.C. Rename DISKLIST.C to DISKLIST.C1. It
works on most dot matrix printers. The contents of DISKLIST.C1
are:
27,71,-1
27,72,-1
If you do not have a laser printer, you may delete the file
DISKLIST.LSR so DISKLIST doesn't have to take the time to read it.
LASER COMMANDS
DISKLIST has a set of laser commands in the file DISKLIST.LSR for
each format. It also has a laser command editor, accessed with
F6, so you can easily change them. The laser commands are setup
in the following categories:
Symbol
Spacing
Pitch & Point Size
Orientation
Top Margin
Lines per inch
Left Margin, Row
Reset
You can put any commands on any line. These categories are for
reference only. Just remember, when laser printer is selected,
DISKLIST concatenates all of the commands in the first 7
categories and sends them to the printer. After the list is
printed, DISKLIST sends the commands in the eighth category,
Reset. You don't have to have any laser commands, and there is a
key (F8) to delete all commands for a format. Or, you can delete
the file DISKLIST.LSR and that will clear out all of the commands
and DISKLIST will still run.
For Output Device selections Avery-Laser and Sleeve on LJ 3, the
laser commands are in the program and cannot be changed.
Laser commands are all printable ASCII characters except ESC.
The IBM character set displays ESC as a left pointing arrow. So
does DISKLIST. To enter ESC on the command line, just press the
ESC key. Now, since the ESC key is used for input, how do you
get out of the editor? Press Function Key 10. To be consistent,
DISKLIST will quit all functions when F10 is pressed.
There is a space after ESC in this documentation for clarity. In
the actual HP laser command there is no space. In the laser
command editor the ESC is displayed as a left arrow with no
-11-
space. The laser editor has the following functions:
F1 - Help
F2 - Copy to Pass Buffer
F3 - Insert from Pass Buffer
F6 - Insert Default Commands
F7 - Clear Active Command Line
F8 - Clear All Commands for this size
F9 - Save All Commands for all sizes
F10 - EXIT
When in the laser editor, you may select another format with
F11 & F12, or ALT or Control with the left and right arrows.
The file DISKLIST.LSR is an ASCII file. It can also be edited
with a text word processor like EDIT in DOS 5.0 or PC-WRITE.
Each format has an ID number. These numbers and the format name
are written to the file so you can locate the commands. When
DISKLIST reads this file, it uses the ID number to identify the
format, but it ignores the name. It only needs the commands for
the formats that you want to use, and the formats do not have to
be in sequence in this file.
The default laser commands include a reset command ESC E with the
symbol command ESC (10U. The HP reset command is ESC E. If you
want to print more than one list on a page, then remove both of
the reset commands (ESC E) because it forces a form feed. You
may then force a form feed with E for Eject Page or CTRL R from
the control window. CTRL R sends the laser command ESC E to the
printer. So does CTRL E, ALT R, & ALT E.
If your laser printer always ejects a blank page when using
DISKLIST, then remove the first ESC E. Some users have reported
that problem.
The top margin command is ESC &l#E. That is a lowercase L before
the # sign and not the number 1. Replace the # with the line
number of the top line of the label.
You may want to change the laser commands that adjust where the
label is printed, i.e. the starting left margin and top row. The
default commands for these are ESC &a0l1R. Again that is a lower
case L after the &a0. These define the upper left corner of the
list. Replace the zero with the number of the column to start
the list (left margin) and the one with the line number (row).
You may want to try replacing the one before the R with a zero to
print closer to the top of the page. Some laser printers may cut
off the top part of the first line if you print on row zero.
You may want to print multiple labels on one sheet. First remove
the ESC E commands. Press F6 to get into the Laser Command Setup
-12-
to remove the ESC E. After printing the first list, press F6 to
get into the Laser Command Setup again. Move down to Left
Margin, Row, and change the HP command of what line to start on.
Change the decimal number before the R in the command string from
1 to 30. After printing the second list, press Ctrl E to eject
the page. Try other numbers to gain experience positioning the
list where you want it.
You may print starting at row 30 first, then delete the 3 and
print to row 0 next. Think of a laser printer as a screen where
you can jump around the page and not as a dot matrix printer
where you always have to print from top to bottom. 3½ inch
formats can be printed side by side, as is done for Avery labels.
F2 and F3 operate a pass buffer. They are used to copy the laser
commands one format to another. F2 copies the laser commands
from the displayed format to the pass buffer. Select another
format, press F3 and the laser commands from the pass buffer are
copied to this format.
F9 saves all the laser commands to the file DISKLIST.LSR.
DISKLIST will not automatically save the laser commands when it
quits like it does the configuration - so use F9. F6 will
replace all the laser commands for one format with the default
laser commands that were originally in DISKLIST.LSR.
DISKLIST prints the disk volume name and the title in bold
italic. If the font does not have bold italic, the printer will
print normal. The command that is sent for bold italic is
ESC (s1s7B and to return to normal, ESC (s0s0B. These commands
are coded into DISKLIST and can't be changed. If this causes
problems with any printer, please let me know and I will fix the
problem.
If you are only going to use DISKLIST with a laser printer, I
suggest that you remove all nonlaser printer codes. See the
previous section on Nonlaser Printer Control Codes. Use the C
command to clear all codes then exit. Select Laser Printer for
item 5 on the Control Window. This will prevent the accidental
sending of nonlaser codes to a laser printer.
See the file DISKLASR.DOC for additional information on laser
commands.
DESKJET
The Hewlett Packard DeskJet has commands similar to the HP
LaserJet. Select Laser Printer for the Output Device in the
control window.
-13-
For compressed print, the DeskJet, without a font cartridge,
always prints 6 point characters. Compressed print on laser and
dot matrix printers is 8.5 point. The effect of this is that the
vertical lines did not connect to form a contiguous frame like it
does in the normal 10 cpi mode. I was able to make the
compressed lines print closer together by using the laser command
editor (F6) to change the Lines per inch command from ESC &l8D to
ESC &l12D. This changed the lines per inch from 8 to 12.
The Output Device Avery-Laser doesn't work properly on a DeskJet
because, unlike a laser printer where the paper doesn't move
until a page is ejected, the DeskJet moves the paper when
printing the first label, and can't backup to begin printing the
second. You may still use the Avery-Laser feature by printing
one column of labels only.
AVERY LASER LABELS
DISKLIST now prints on Avery labels #5196 and #5197. You may
select exactly which label to print on, and how many copies to
make. If you want to make more copies than will fit on a sheet,
DISKLIST will eject a full sheet and continue on the next. You
can also tell DISKLIST what label positions on the Avery sheet to
not print on. Once DISKLIST prints on a label or you mark it to
be skipped, DISKLIST remembers for that sheet. You can print the
labels for 9 disks on the sheet for 3.5 inch disks and 12 on the
sheet for 5.25 inch disks. Remember to press ALT E to eject a
partial page. When you press P to print on a different output
device, other than File or Screen, after you printed on the
Avery-Laser output device, DISKLIST will automatically eject the
sheet in the laser printer, provided you haven't switched the
printer port (the LPT number - described below) also.
All of the laser commands to locate and print on Avery labels are
imbedded in the program. They are standard HP commands and
should work on any laser printer that emulates the HP.
Not all label formats will fit on these labels, so DISKLIST
indicates the types that do as 'Label - AVERY' under Type at the
bottom of the screen.
Select 'Avery-Laser' for the Output Device (Parameter 5 in the
Control Window). Select a Format that supports Avery labels.
This information is displayed at the lower right corner of the
screen under Type. If this information is not displayed, press
control L. The type needed is Label - AVERY.
When you press P to print the label, one of the following screens
will appear depending on the disk label size:
-14-
AVERY Label Sheet # 5196
┌─────────┬─────────┬─────────┐
│ │ │ │
│ │ │ │
│ 1 │ 2 │ 3 │
Select a Label Position to │ │ │ │
use (ESC to Exit) [1]? │ │ │ │
├─────────┼─────────┼─────────┤
Enter a negative value to mark │ │ │ │
a position as used. │ │ │ │
│ 4 │ 5 │ 6 │
│ │ │ │
│ │ │ │
├─────────┼─────────┼─────────┤
│ │ │ │
│ │ │ │
│ 7 │ 8 │ 9 │
│ │ │ │
│ │ │ │
└─────────┴─────────┴─────────┘
AVERY Label Sheet # 5197
┌──────────────┬──────────────┐
│ 1 │ 2 │
│ │ │
├──────────────┼──────────────┤
Select a Label Position to │ 3 │ 4 │
use (ESC to Exit) [1]? │ │ │
├──────────────┼──────────────┤
Enter a negative value to mark │ 5 │ 6 │
a position as used. │ │ │
├──────────────┼──────────────┤
│ 7 │ 8 │
│ │ │
├──────────────┼──────────────┤
│ 9 │ 10 │
│ │ │
├──────────────┼──────────────┤
│ 11 │ 12 │
│ │ │
└──────────────┴──────────────┘
If you want to prevent printing in a specific position on a
sheet, enter the position number as a negative value. If you
want to block out label 4, enter -4. DISKLIST fills used cells
on the screen to indicate labels that are not available.
After selecting a position to print, you will be asked how many
copies. If you have already printed one label and it was cell 3,
and you select to print the next label in cell 4, and then you
-15-
request 4 copies, DISKLIST will print the four copies in cells 4,
1, 2, 5. It did that because 1 and 2 were not used or blocked.
PRINT ON DISK SLEEVES
DISKLIST will print lists and label formats, both 3.5 and 5.25
sizes, on the sleeve of 5.25 inch diskettes. However, this works
ONLY ON PRINTERS WITH PCL5 and ONLY ON PLAIN PAPER SLEEVES, NOT
TYVEK. PCL5 is standard on HP Laser Jet III series and available
on newer versions of some other brands. The reason it only works
with PCL5 is because DISKLIST uses a PCL5 command that causes the
laser to print upside down. The reason for this will become
evident in the next paragraph. Do not use Tyvek sleeves because
they may melt in the printer.
Because of the short length of the sleeve, you must use the
following procedure to ensure that the sleeve will travel through
the printer. Cut a piece of 8.5 x 11 inch paper in half (two 8.5
x 5.5 pieces). Insert one piece into a plain paper diskette
sleeve. Push it all the way to the bottom of the sleeve. Using
the single sheet feeder, feed the sleeve and sheet into the laser
printer, with the bottom of the sleeve going in first. The
printer feeder mechanism will push the sleeve through the printer
by pushing on the sheet of paper.
Select 'Sleeve on LJ 3' for the Output Device (Parameter 5 in the
Control Window). Select any format. If the format is too wide
to fit on the sleeve, DISKLIST will tell you when you press P to
print. All of the laser commands to print on the sleeve are
embedded in the program. If there are more lines to print than
will fit on a sleeve, the list will continue on the next page.
You will have to adjust the Lines Per List, item 8 in the control
window, to a lower value when you are printing a format with a
border. This is to prevent the bottom of the border from being
printed on the next page.
SWITCH PRINTER PORT
In the control window there is a command, T - LPT1:, to switch
printer ports from LPT1: to LPT2: to LPT3:. Just press T. Try
printing a DISKLIST if you have more than one printer. Remember
to change the Output Device if one printer is a laser and the
other is not. If it works, skip the rest of this section.
Switching printer ports may not work if you are using a print
spooler. It does work with the spooler I use, DMP. If you have
a serial printer, you must have set it up with the DOS MODE
command before starting DISKLIST.
-16-
PAGE TAB VALUE
The Page format has built in tabs for the first column of each
format. You may want to change them. Create a text file called
DISKLIST.TAB. Enter the tabs you want for each of the seven page
formats separated by
commas. The default tabs starting with format 8.5 x 11 Page and
ending with Page 6 Across are: 19, 22, 8, 23, 10, 30, 22.
If the file DISKLIST.TAB is in the same directory as DISKLIST.EXE
then DISKLIST will read it and use these values. Otherwise it
skips it and uses the above default values.
LASER DOWNLOAD
DISKLIST will download your soft fonts for you. Here's how.
Create an ASCII file with a text editor or word processor. Name
this file DISKLIST.FNT. Insert the DOS file name and a
description of the font. Place a comma after the DOS file name.
You may enter up to 10 names, each must be on a different line.
Example:
CO085R16.USP, Courier 8.5 Point 16.6 Pitch
RO100R12.UPS, Times Roman 10 Point 12 Pitch
Copy your font files and DISKLIST.FNT to the directory with
DISKLIST.EXE. Fonts do not come with DISKLIST.
The download section is accessed by pressing F3 from the Control
window, or selection 5 from the configuration window. DISKLIST
will display the file names and fonts and you select the one to
download. DISKLIST will download the font and select it. The HP
command codes that DISKLIST uses are given in the file
DISKLIST.LZR.
You may have to change the laser commands, particularly the Lines
per inch, to properly utilize this font, or delete them all with
F8. You may also want to change the Lines per List, parameter 8
in the Command window. Also remove the two reset commands, ESC E,
since either may delete the downloaded font.
TEXT INPUT
There are several prompts where DISKLIST asks for text input.
All follow these rules. DISKLIST always presents the previous
data in that field for you to edit if you wish. ESC will erase
the entire line. All standard editing features of the computer
are available: insert, delete, home, end, left and right arrows.
-17-
DISKLIST has a novel feature. If you want to enter more
characters than will fit into the input window, then DISKLIST
scrolls the text sideways. All data will not be displayed in the
text window, but it will be used. One exception is the filespec
input. It will truncate any input to eight characters before the
period and three after the period to comply with DOS standards.
When a title for a disk is entered, it will be displayed at the
bottom of the control window as illustrated by the text in the
control window display above, "The List Title is Displayed Here".
To reuse the title, save it with the S command. DISKLIST will
save it on the disk drive selected by parameter 1 on the control
window. Retrieve it the next time with the R command.
Press RETURN or the up or down arrow when you are finished with a
text input.
STATUS MESSAGES
Status messages are displayed in a pop up window. In some cases,
such as error messages, you are prompted to press any key to
continue. In other cases, such as completion messages, they are
displayed for a few seconds then go away. You do not have to
wait for these latter messages to go away before entering a
command.
When you are producing a list, DISKLIST will display the path and
file names as it prints them in a status window. Sometimes this
goes too fast to read, but the purpose is to let you know that
something is happening. DISKLIST will STOP PROCESSING a list IF
ANY KEY IS PRESSED and beeps to alert you that it stopped
prematurely. When you accidentally start to print the directory
of your hard drive, press any key to stop.
DISKLIST requires 256 K of free memory and DOS 2.1 or later.
MONOCHROME MONITOR
The highlight of the selected parameter in the Control Window and
the Format Selection Window may not be visible on monochrome
monitors. To make it possible for such users to know which
parameter is selected, press M to toggle the display of arrows
before the item on and off.
-18-
SUMMARY OF NON-DISPLAYED COMMANDS.
M Toggles display arrows for monochrome monitors.
^B Toggles the blind command action beeper on/off.
^L Toggles display of Format data at bottom of screen.
^E Sends the laser printer reset command ESC E.
^R Sends the laser printer reset command ESC E.
^ means hold the Control Key down, then press the letter. You
may use the ALT key instead of the Control Key for these four
keys.
FILENAMES
The names and purpose of all DISKLIST system files are listed
below. There are no hidden files. Only the first five files are
distributed with DISKLIST. The next three are created by
DISKLIST, and the last two are created by you.
DISKLIST.EXE Program
DISKLIST.DOC Documentation
DISKLIST.LSR HP LaserJet Commands for each format
DISKLASR.DOC Additional documentation on LaserJet Commands
DISKLIST.C Data file for double strike printer codes
Change name to DISKLIST.C1 to use
DISKLIST.PRM Saved program configuration & nonlaser
printer control codes
DISKLIST.TTL Disk title
DISKLIST.TXT Default file name or a list output to a disk
DISKLIST.FNT File containing names of your softfonts
DISKLIST.TAB Optional tab values for page formats
-19-
DISKFLAP
Lists for 5.25 inch disks can be kept in the disk sleeve. Some
3.5 inch disks have plastic sleeves, but few people use them.
DISKLIST lists can be attached to a 3.5 inch disk in a way that
allows them to remain attached when inserted in most floppy
drives. The list can even be read when it is in horizontal
drives.
This is accomplished by tapping the list to the back of the
diskette with one small piece of tape placed along the edge of
the diskette that doesn't go into the drive. You then have a
list that stays attached to the diskette even when it is inserted
in the drive.
Edge of disk that
does not go into drive
_______=====________ _ <-----Masking Tape Hinge
| | | |\
| [] | | | \
| | | | \
| | | | \<------ List printed
| 0 | | | \ by DISKLIST
| | | | \ Printed side
| Front of | | | \ out
| 3.5 " disk | | | \
| | | | \
\___________________| |_|
Front View Side View
The tape only has to be 3/4 to 1 inch by 1/2 inch. When you cut
the list out, leave about 1/4 inch of paper above the printed
frame of the list. Place the list on the back of the disk with
the top edge of the list along the back edge of the disk,
printed side out. Tape the list to the disk.
The tape acts as a hinge so the list can fold against the disk
for storage, or fold straight out away from the disk when the
disk is inserted into the drive. Masking tape works best and the
list can be pulled from the tape to be replaced. Scotch tape
also works.
SHAREWARE
DISKLIST is NOT a public domain program. It is copyrighted and
distributed as Shareware. DISKLIST may be distributed on
bulletin boards, by computer user groups and by disk vendors.
-20-
DISKLIST.EXE, DISKLIST.DOC, DISKLASR.DOC, DISKLIST.LSR, and
DISKLIST.C must be distributed together and unaltered.
If, after evaluating DISKLIST, you decide to use it or keep it
for when you will need it, then you MUST submit the registration
fee. The registration form must be printed from DISKLIST with
the F command.
When you register DISKLIST you will receive:
Telephone and mail support.
A copy of the latest version of DISKLIST
Removal of the Registration Screen & reminders.
Skip the Help screen at start of the program.
Skip the Registration Form reminder at the end
of the program.
A loan amortization program with both the BASIC
source code and the compiled program. No
registration is required for the amortization
program.
A Copy of SHERLOCK for you to try before registering.
You will also receive a free introductory membership certificate
to CompuServe with a $15.00 credit towards online time.
Your registered copy of DISKLIST will NOT display the initial
Shareware title screen, the registration reminders, or the
initial or laser command setup help screens.
Because I will send you all of this software, please indicate on
the registration form the size of the floppy disks that you can
use.
The registration fee is 25.00. Maryland residents add 5% state
sales tax ($1.25). Orders outside of the United States add $3
for postage & handling. All checks and money orders must be in
US funds and drawn on a US bank. Visa, MasterCard or American
Express may be used. This price may change, but not in 1992.
Most copies of software on bulletin boards and even in software
vendor libraries are not the latest version. It takes a long
time for these to get around, and most of the effort is placed on
the widest distribution of the initial release. And with so much
emphases being placed on 'safe software' these days, where is
there a more reliable place to obtain your software than directly
from an ASP author.
Once in a while DISKLIST will act like it is registered for non
registered users. It starts running without the shareware screen
and displays a window with the message 'Will Run as if
REGISTERED' just to show you how it will run when registered.
-21-
MULTICOPY FEES
The following is the schedule of the multi-copy license fees.
The fee includes one master diskette which you may then copy and
use on the number of machines listed below:
# Users Price
------- -------
5 $ 100.00 ($20 per copy)
10 190.00 ($19 per copy)
25 425.00 ($17 per copy)
50 750.00 ($15 per copy)
100 1,200.00 ($12 per copy)
Site 2,500.00
For corporate, educational institution, and network discounts,
contact Gulf Sierra.
FOREIGN REGISTRATIONS
Registrations from outside of the United States may be made by
sending a check or money order drawn on a US bank in US funds, a
Postal Money Order in US Funds, VISA, MasterCard, or American
Express.
Or, you may arrange to send funds in your currency to a disk
vendor in your country who agrees to forward the full
registration fee in US funds and your name and address to Gulf
Sierra. Gulf Sierra will then send the registration package
directly to you. Contact a disk vendor for details and amount to
send him. Vendors may apply a small handling fee.
Some vendors who have agreed to do this and will send your name
and registration fee to me by electronic mail are:
BUDGETWARE, 9 Albermarle Street, Newtown NSW 2042, AUSTRALIA
Phone 011-612-519-4233
DKR Software, P.O. Box 372, Brighton, South Australia 5046
Phone 08 3770049
COPYSOFT, Rue de Menuisier 109, 1200 Bruxelles, Belgium
EPILOGUE
Please report discrepancies (bugs) that you find in DISKLIST.
Include sufficient information for me to replicate the incident.
When I correct a bug, the person who reported it gets the first
copy.
Whenever you write, please include your home phone number. You
can also send CompuServe mail to me. My CompuServe ID is
-22-
73270,77. I usually answer questions by phone on the weekend or
early in the evening Eastern time.
If you do not like DISKLIST, please let me know that you tried it
and, if you wish, why you will not use it again. Tell me what
features would have made DISKLIST useful to you. Perhaps you had
a problem because I didn't clearly convey how to use it. Many
features in my software were suggested by people who did not
register. And of course, many more were suggested by those who
did. You may use the registration form to reply and cross out
the word Registration.
COMMERCIAL LABELS
One company that produces stick on labels for both form fed
printers and laser printers is Avery. These labels are available
from many office supply stores and catalogs.
The Avery disk labels are: Catalog
Label Size Number
For 3.5" disks and form fed printers 2.75 x 2.75 4241
For 5.25" disks and form fed printers 1.25 x 4.75 4240
For 3.5" disks and laser printers 2.75 x 2.75 5196
For 5.25" disks and laser printers 1.50 x 4.00 5197
PERSONAL TRIMMER
I use a personal trimmer to neatly cut my DISKLIST lists. It is
a compact size paper cutter that lets you trim paper - or just
about anything - up to six inches in length. It features
self-sharpening stainless steel blades for easy cutting and a
sure grip handle. It is 5 inches wide, 8 inches deep and 1.5
inches high. It is MADE IN THE USA.
-23-
The Personal Paper Trimmer (tm)
- Self Sharpening Blades
- Trims up to 6 inch lengths
SMART The intelligent way to cut a straight line
FAST and EASY - Trim those small but important everyday jobs in
just seconds
ACCURATE and PRECISE - Gives a clean professional edge. Perfect
for squaring uneven sheets.
HUNDREDS OF PERSONAL USES - For the Office, School or Home. Slice
open envelops, cut index cards to size or custom labels;
trim handmade cards, invitations, photos, stamps, films,
coupons; just about anything! Ideal for Artists,
Students and Hobbyists - or anyone who wants to put a
neat professional edge on their work.
2 SECTION STORAGE TRAY - Unit includes a convenient storage tray
for paper clips, stamps, pushpins, note-pads, etc.
FEATURES Quality Stainless Steel Blades working in tandem to cut
clearly and smoothly through as many as 5 sheets of
paper at once. Unit trims up to 6" lengths.
Standard 1/8" printed rules and a 1/2" alignment grid
etched into surface to aid accuracy.
Clear Safety Guard keeps fingers safely away from the
cutting edge.
Unit is made of sturdy plastic. Measures approximately
5" x 8" x 1.5"
You may order this from me when you register DISKLIST. It costs
$15 + $4 for shipping and handling. Ordering information is on the
registration form that can be printed from DISKLIST. Gulf Sierra
reserves the right to withdraw this offer or change the price at
any time.
OMBUDSMAN
I am a member of the Association of Shareware Professionals
(ASP). ASP wants to make sure that the Shareware principle works
for you. If you are unable to resolve a Shareware-related
problem with an ASP member by contacting the member directly, ASP
may be able to help.
The ASP Ombudsman can help you resolve a dispute or problem with
an ASP member, but does not provide technical support for
members' products. Please write to the ASP Ombudsman at 545
Grover Road, Muskegon, MI 49442-9427 or send a CompuServe message
via CompuServe mail to ASP Ombudsman 70007,3536.
-24-
IBM GRAPHICS EXAMPLE
This is an example of another format for the DISKLIST output. It
can be seen on the computer screen and printed on a printer setup
for IBM graphics. If this figure is not framed in continuous
lines, then your printer is not setup for IBM graphics. Read your
printer manual to determine if it is possible to switch to that
mode. Otherwise, you can still use DISKLIST with the ASCII
character frame as illustrated on page 1.
┌────────────────────────────────────────────────┐
│ GREAT SHAREWARE │
│ Volume ID is DISKLIST │
│ 1,457,664 Total Space 893,440 Bytes Free │
├────────────────────────────────────────────────┤
│ A:\ 153,664 BYTES │
│ DISKLIST.DOC 34,377 08/15/90 19:32:16 │
│ DISKLIST.EXE 119,144 08/14/90 22:02:18 │
│ DISKLIST.PRM 124 03/25/90 11:11:48 │
│ DISKLIST.TTL 19 03/25/90 11:05:06 │
│ │
│ A:\PC-ACCOU.NT 230,862 BYTES │
│ PCACT220.EXE 156,150 11/08/89 19:03:52 │
│ PCACT220.TXT 6,838 11/09/89 18:30:42 │
│ PCDOC220.EXE 67,874 11/08/89 19:09:22 │
│ │
│ A:\SHERLOCK 175,967 BYTES │
│ SHERLOCK.DOC 30,895 08/15/90 19:35:14 │
│ SHERLOCK.EXE 145,072 08/15/90 19:44:04 │
├────────────────────────────────────────────────┤
│ 9 Files 08-17-1990 18:46:20 │
│ │
│ │
│ │
│ │
│ │
│ │
│ │
│ Created by DISKLIST │
└────────────────────────────────────────────────┘
This is shown in the 5.25 inch normal format. DISKLIST can also
print in 38 other formats.
-25-